<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>cluster_model_components [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_matching.html">Matching</a> / <a href="toc_matching_componentbased.html">Component-Based</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">cluster_model_components</span><span data-if="c" style="display:none;">T_cluster_model_components</span><span data-if="cpp" style="display:none;">ClusterModelComponents</span><span data-if="dotnet" style="display:none;">ClusterModelComponents</span><span data-if="python" style="display:none;">cluster_model_components</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">cluster_model_components</span><span data-if="c" style="display:none;">T_cluster_model_components</span><span data-if="cpp" style="display:none;">ClusterModelComponents</span><span data-if="dotnet" style="display:none;">ClusterModelComponents</span><span data-if="python" style="display:none;">cluster_model_components</span></code> — Adopt new parameters that are used to create the model components into the
training result.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>cluster_model_components</b>(<a href="#TrainingImages"><i>TrainingImages</i></a> : <a href="#ModelComponents"><i>ModelComponents</i></a> : <a href="#ComponentTrainingID"><i>ComponentTrainingID</i></a>, <a href="#AmbiguityCriterion"><i>AmbiguityCriterion</i></a>, <a href="#MaxContourOverlap"><i>MaxContourOverlap</i></a>, <a href="#ClusterThreshold"><i>ClusterThreshold</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_cluster_model_components</b>(const Hobject <a href="#TrainingImages"><i>TrainingImages</i></a>, Hobject* <a href="#ModelComponents"><i>ModelComponents</i></a>, const Htuple <a href="#ComponentTrainingID"><i>ComponentTrainingID</i></a>, const Htuple <a href="#AmbiguityCriterion"><i>AmbiguityCriterion</i></a>, const Htuple <a href="#MaxContourOverlap"><i>MaxContourOverlap</i></a>, const Htuple <a href="#ClusterThreshold"><i>ClusterThreshold</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>ClusterModelComponents</b>(const HObject&amp; <a href="#TrainingImages"><i>TrainingImages</i></a>, HObject* <a href="#ModelComponents"><i>ModelComponents</i></a>, const HTuple&amp; <a href="#ComponentTrainingID"><i>ComponentTrainingID</i></a>, const HTuple&amp; <a href="#AmbiguityCriterion"><i>AmbiguityCriterion</i></a>, const HTuple&amp; <a href="#MaxContourOverlap"><i>MaxContourOverlap</i></a>, const HTuple&amp; <a href="#ClusterThreshold"><i>ClusterThreshold</i></a>)</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HComponentTraining.html">HComponentTraining</a>::<b>ClusterModelComponents</b>(const HImage&amp; <a href="#TrainingImages"><i>TrainingImages</i></a>, const HString&amp; <a href="#AmbiguityCriterion"><i>AmbiguityCriterion</i></a>, double <a href="#MaxContourOverlap"><i>MaxContourOverlap</i></a>, double <a href="#ClusterThreshold"><i>ClusterThreshold</i></a>) const</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HComponentTraining.html">HComponentTraining</a>::<b>ClusterModelComponents</b>(const HImage&amp; <a href="#TrainingImages"><i>TrainingImages</i></a>, const char* <a href="#AmbiguityCriterion"><i>AmbiguityCriterion</i></a>, double <a href="#MaxContourOverlap"><i>MaxContourOverlap</i></a>, double <a href="#ClusterThreshold"><i>ClusterThreshold</i></a>) const</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HComponentTraining.html">HComponentTraining</a>::<b>ClusterModelComponents</b>(const HImage&amp; <a href="#TrainingImages"><i>TrainingImages</i></a>, const wchar_t* <a href="#AmbiguityCriterion"><i>AmbiguityCriterion</i></a>, double <a href="#MaxContourOverlap"><i>MaxContourOverlap</i></a>, double <a href="#ClusterThreshold"><i>ClusterThreshold</i></a>) const  <span class="signnote">
            (
            Windows only)
          </span></code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HImage.html">HImage</a>::<b>ClusterModelComponents</b>(const HComponentTraining&amp; <a href="#ComponentTrainingID"><i>ComponentTrainingID</i></a>, const HString&amp; <a href="#AmbiguityCriterion"><i>AmbiguityCriterion</i></a>, double <a href="#MaxContourOverlap"><i>MaxContourOverlap</i></a>, double <a href="#ClusterThreshold"><i>ClusterThreshold</i></a>) const</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HImage.html">HImage</a>::<b>ClusterModelComponents</b>(const HComponentTraining&amp; <a href="#ComponentTrainingID"><i>ComponentTrainingID</i></a>, const char* <a href="#AmbiguityCriterion"><i>AmbiguityCriterion</i></a>, double <a href="#MaxContourOverlap"><i>MaxContourOverlap</i></a>, double <a href="#ClusterThreshold"><i>ClusterThreshold</i></a>) const</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HImage.html">HImage</a>::<b>ClusterModelComponents</b>(const HComponentTraining&amp; <a href="#ComponentTrainingID"><i>ComponentTrainingID</i></a>, const wchar_t* <a href="#AmbiguityCriterion"><i>AmbiguityCriterion</i></a>, double <a href="#MaxContourOverlap"><i>MaxContourOverlap</i></a>, double <a href="#ClusterThreshold"><i>ClusterThreshold</i></a>) const  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>ClusterModelComponents</b>(<a href="HObject.html">HObject</a> <a href="#TrainingImages"><i>trainingImages</i></a>, out <a href="HObject.html">HObject</a> <a href="#ModelComponents"><i>modelComponents</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ComponentTrainingID"><i>componentTrainingID</i></a>, <a href="HTuple.html">HTuple</a> <a href="#AmbiguityCriterion"><i>ambiguityCriterion</i></a>, <a href="HTuple.html">HTuple</a> <a href="#MaxContourOverlap"><i>maxContourOverlap</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ClusterThreshold"><i>clusterThreshold</i></a>)</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HComponentTraining.html">HComponentTraining</a>.<b>ClusterModelComponents</b>(<a href="HImage.html">HImage</a> <a href="#TrainingImages"><i>trainingImages</i></a>, string <a href="#AmbiguityCriterion"><i>ambiguityCriterion</i></a>, double <a href="#MaxContourOverlap"><i>maxContourOverlap</i></a>, double <a href="#ClusterThreshold"><i>clusterThreshold</i></a>)</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HImage.html">HImage</a>.<b>ClusterModelComponents</b>(<a href="HComponentTraining.html">HComponentTraining</a> <a href="#ComponentTrainingID"><i>componentTrainingID</i></a>, string <a href="#AmbiguityCriterion"><i>ambiguityCriterion</i></a>, double <a href="#MaxContourOverlap"><i>maxContourOverlap</i></a>, double <a href="#ClusterThreshold"><i>clusterThreshold</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>cluster_model_components</b>(<a href="#TrainingImages"><i>training_images</i></a>: HObject, <a href="#ComponentTrainingID"><i>component_training_id</i></a>: HHandle, <a href="#AmbiguityCriterion"><i>ambiguity_criterion</i></a>: str, <a href="#MaxContourOverlap"><i>max_contour_overlap</i></a>: float, <a href="#ClusterThreshold"><i>cluster_threshold</i></a>: float) -&gt; HObject</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p>With <code><span data-if="hdevelop" style="display:inline">cluster_model_components</span><span data-if="c" style="display:none">cluster_model_components</span><span data-if="cpp" style="display:none">ClusterModelComponents</span><span data-if="com" style="display:none">ClusterModelComponents</span><span data-if="dotnet" style="display:none">ClusterModelComponents</span><span data-if="python" style="display:none">cluster_model_components</span></code> you can modify parameters
<em>after</em> a first training has been performed using
<a href="train_model_components.html"><code><span data-if="hdevelop" style="display:inline">train_model_components</span><span data-if="c" style="display:none">train_model_components</span><span data-if="cpp" style="display:none">TrainModelComponents</span><span data-if="com" style="display:none">TrainModelComponents</span><span data-if="dotnet" style="display:none">TrainModelComponents</span><span data-if="python" style="display:none">train_model_components</span></code></a>. <code><span data-if="hdevelop" style="display:inline">cluster_model_components</span><span data-if="c" style="display:none">cluster_model_components</span><span data-if="cpp" style="display:none">ClusterModelComponents</span><span data-if="com" style="display:none">ClusterModelComponents</span><span data-if="dotnet" style="display:none">ClusterModelComponents</span><span data-if="python" style="display:none">cluster_model_components</span></code>
sets the criterion <a href="#AmbiguityCriterion"><i><code><span data-if="hdevelop" style="display:inline">AmbiguityCriterion</span><span data-if="c" style="display:none">AmbiguityCriterion</span><span data-if="cpp" style="display:none">AmbiguityCriterion</span><span data-if="com" style="display:none">AmbiguityCriterion</span><span data-if="dotnet" style="display:none">ambiguityCriterion</span><span data-if="python" style="display:none">ambiguity_criterion</span></code></i></a> that is used to solve
the ambiguities, the maximum contour overlap
<a href="#MaxContourOverlap"><i><code><span data-if="hdevelop" style="display:inline">MaxContourOverlap</span><span data-if="c" style="display:none">MaxContourOverlap</span><span data-if="cpp" style="display:none">MaxContourOverlap</span><span data-if="com" style="display:none">MaxContourOverlap</span><span data-if="dotnet" style="display:none">maxContourOverlap</span><span data-if="python" style="display:none">max_contour_overlap</span></code></i></a>, and the cluster threshold of the training
result <a href="#ComponentTrainingID"><i><code><span data-if="hdevelop" style="display:inline">ComponentTrainingID</span><span data-if="c" style="display:none">ComponentTrainingID</span><span data-if="cpp" style="display:none">ComponentTrainingID</span><span data-if="com" style="display:none">ComponentTrainingID</span><span data-if="dotnet" style="display:none">componentTrainingID</span><span data-if="python" style="display:none">component_training_id</span></code></i></a> to the specified values.  A
detailed description of these parameters can be found in the
documentation of <a href="train_model_components.html"><code><span data-if="hdevelop" style="display:inline">train_model_components</span><span data-if="c" style="display:none">train_model_components</span><span data-if="cpp" style="display:none">TrainModelComponents</span><span data-if="com" style="display:none">TrainModelComponents</span><span data-if="dotnet" style="display:none">TrainModelComponents</span><span data-if="python" style="display:none">train_model_components</span></code></a>. By modifying these
parameters, the way in which the initial components are merged into
rigid model components changes.  For example, the greater the
cluster threshold is chosen, the fewer initial components are
merged. You can select suitable parameter values interactively by
repeatedly calling <a href="inspect_clustered_components.html"><code><span data-if="hdevelop" style="display:inline">inspect_clustered_components</span><span data-if="c" style="display:none">inspect_clustered_components</span><span data-if="cpp" style="display:none">InspectClusteredComponents</span><span data-if="com" style="display:none">InspectClusteredComponents</span><span data-if="dotnet" style="display:none">InspectClusteredComponents</span><span data-if="python" style="display:none">inspect_clustered_components</span></code></a> with
different parameter values and then setting the chosen values by
using <a href="get_training_components.html"><code><span data-if="hdevelop" style="display:inline">get_training_components</span><span data-if="c" style="display:none">get_training_components</span><span data-if="cpp" style="display:none">GetTrainingComponents</span><span data-if="com" style="display:none">GetTrainingComponents</span><span data-if="dotnet" style="display:none">GetTrainingComponents</span><span data-if="python" style="display:none">get_training_components</span></code></a>.
</p>
<p>The rigid model components are returned in
<a href="#ModelComponents"><i><code><span data-if="hdevelop" style="display:inline">ModelComponents</span><span data-if="c" style="display:none">ModelComponents</span><span data-if="cpp" style="display:none">ModelComponents</span><span data-if="com" style="display:none">ModelComponents</span><span data-if="dotnet" style="display:none">modelComponents</span><span data-if="python" style="display:none">model_components</span></code></i></a>. In order to receive reasonable results, it
is essential that the same training images that were used to perform
the training with <a href="train_model_components.html"><code><span data-if="hdevelop" style="display:inline">train_model_components</span><span data-if="c" style="display:none">train_model_components</span><span data-if="cpp" style="display:none">TrainModelComponents</span><span data-if="com" style="display:none">TrainModelComponents</span><span data-if="dotnet" style="display:none">TrainModelComponents</span><span data-if="python" style="display:none">train_model_components</span></code></a> are passed in
<a href="#TrainingImages"><i><code><span data-if="hdevelop" style="display:inline">TrainingImages</span><span data-if="c" style="display:none">TrainingImages</span><span data-if="cpp" style="display:none">TrainingImages</span><span data-if="com" style="display:none">TrainingImages</span><span data-if="dotnet" style="display:none">trainingImages</span><span data-if="python" style="display:none">training_images</span></code></i></a>. The pose of the newly clustered components
within the training images is determined using the shape-based
matching.  As in <a href="train_model_components.html"><code><span data-if="hdevelop" style="display:inline">train_model_components</span><span data-if="c" style="display:none">train_model_components</span><span data-if="cpp" style="display:none">TrainModelComponents</span><span data-if="com" style="display:none">TrainModelComponents</span><span data-if="dotnet" style="display:none">TrainModelComponents</span><span data-if="python" style="display:none">train_model_components</span></code></a>, one can decide
whether the shape models should be pregenerated by using
<a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system('pregenerate_shape_models',...)</span><span data-if="c" style="display:none">set_system("pregenerate_shape_models",...)</span><span data-if="cpp" style="display:none">SetSystem("pregenerate_shape_models",...)</span><span data-if="com" style="display:none">SetSystem("pregenerate_shape_models",...)</span><span data-if="dotnet" style="display:none">SetSystem("pregenerate_shape_models",...)</span><span data-if="python" style="display:none">set_system("pregenerate_shape_models",...)</span></code></a>.
Note that, if for a certain pyramid level the model touches the
image border, it might not be found even if it lies completely
within the original image.
<a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system('border_shape_models',...)</span><span data-if="c" style="display:none">set_system("border_shape_models",...)</span><span data-if="cpp" style="display:none">SetSystem("border_shape_models",...)</span><span data-if="com" style="display:none">SetSystem("border_shape_models",...)</span><span data-if="dotnet" style="display:none">SetSystem("border_shape_models",...)</span><span data-if="python" style="display:none">set_system("border_shape_models",...)</span></code></a> can be used to
determine whether the models must lie completely within the training
images or whether they can extend partially beyond the image border.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="TrainingImages" class="parname"><b><code><span data-if="hdevelop" style="display:inline">TrainingImages</span><span data-if="c" style="display:none">TrainingImages</span><span data-if="cpp" style="display:none">TrainingImages</span><span data-if="com" style="display:none">TrainingImages</span><span data-if="dotnet" style="display:none">trainingImages</span><span data-if="python" style="display:none">training_images</span></code></b> (input_object)  </span><span>(multichannel-)image(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject</span> (byte / uint2)</span>
</div>
<p class="pardesc">Training images that were used for training the
model components.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ModelComponents" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ModelComponents</span><span data-if="c" style="display:none">ModelComponents</span><span data-if="cpp" style="display:none">ModelComponents</span><span data-if="com" style="display:none">ModelComponents</span><span data-if="dotnet" style="display:none">modelComponents</span><span data-if="python" style="display:none">model_components</span></code></b> (output_object)  </span><span>region(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="c" style="display:none">Hobject *</span></span>
</div>
<p class="pardesc">Contour regions of rigid model components.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ComponentTrainingID" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ComponentTrainingID</span><span data-if="c" style="display:none">ComponentTrainingID</span><span data-if="cpp" style="display:none">ComponentTrainingID</span><span data-if="com" style="display:none">ComponentTrainingID</span><span data-if="dotnet" style="display:none">componentTrainingID</span><span data-if="python" style="display:none">component_training_id</span></code></b> (input_control)  </span><span>component_training <code>→</code> <span data-if="dotnet" style="display:none"><a href="HComponentTraining.html">HComponentTraining</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">HHandle</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">Handle of the training result.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="AmbiguityCriterion" class="parname"><b><code><span data-if="hdevelop" style="display:inline">AmbiguityCriterion</span><span data-if="c" style="display:none">AmbiguityCriterion</span><span data-if="cpp" style="display:none">AmbiguityCriterion</span><span data-if="com" style="display:none">AmbiguityCriterion</span><span data-if="dotnet" style="display:none">ambiguityCriterion</span><span data-if="python" style="display:none">ambiguity_criterion</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Criterion for solving the ambiguities.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'rigidity'</span>
    <span data-if="c" style="display:none">"rigidity"</span>
    <span data-if="cpp" style="display:none">"rigidity"</span>
    <span data-if="com" style="display:none">"rigidity"</span>
    <span data-if="dotnet" style="display:none">"rigidity"</span>
    <span data-if="python" style="display:none">"rigidity"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'distance'</span><span data-if="c" style="display:none">"distance"</span><span data-if="cpp" style="display:none">"distance"</span><span data-if="com" style="display:none">"distance"</span><span data-if="dotnet" style="display:none">"distance"</span><span data-if="python" style="display:none">"distance"</span>, <span data-if="hdevelop" style="display:inline">'distance_orientation'</span><span data-if="c" style="display:none">"distance_orientation"</span><span data-if="cpp" style="display:none">"distance_orientation"</span><span data-if="com" style="display:none">"distance_orientation"</span><span data-if="dotnet" style="display:none">"distance_orientation"</span><span data-if="python" style="display:none">"distance_orientation"</span>, <span data-if="hdevelop" style="display:inline">'orientation'</span><span data-if="c" style="display:none">"orientation"</span><span data-if="cpp" style="display:none">"orientation"</span><span data-if="com" style="display:none">"orientation"</span><span data-if="dotnet" style="display:none">"orientation"</span><span data-if="python" style="display:none">"orientation"</span>, <span data-if="hdevelop" style="display:inline">'rigidity'</span><span data-if="c" style="display:none">"rigidity"</span><span data-if="cpp" style="display:none">"rigidity"</span><span data-if="com" style="display:none">"rigidity"</span><span data-if="dotnet" style="display:none">"rigidity"</span><span data-if="python" style="display:none">"rigidity"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="MaxContourOverlap" class="parname"><b><code><span data-if="hdevelop" style="display:inline">MaxContourOverlap</span><span data-if="c" style="display:none">MaxContourOverlap</span><span data-if="cpp" style="display:none">MaxContourOverlap</span><span data-if="com" style="display:none">MaxContourOverlap</span><span data-if="dotnet" style="display:none">maxContourOverlap</span><span data-if="python" style="display:none">max_contour_overlap</span></code></b> (input_control)  </span><span>real <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">float</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real)</span><span data-if="dotnet" style="display:none"> (<i>double</i>)</span><span data-if="cpp" style="display:none"> (<i>double</i>)</span><span data-if="c" style="display:none"> (<i>double</i>)</span></span>
</div>
<p class="pardesc">Maximum contour overlap of the found initial
components.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0.2</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0.0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0</p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>0.01</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>0.05</p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>0 &lt;= MaxContourOverlap &amp;&amp; MaxContourOverlap &lt;= 1</code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="ClusterThreshold" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ClusterThreshold</span><span data-if="c" style="display:none">ClusterThreshold</span><span data-if="cpp" style="display:none">ClusterThreshold</span><span data-if="com" style="display:none">ClusterThreshold</span><span data-if="dotnet" style="display:none">clusterThreshold</span><span data-if="python" style="display:none">cluster_threshold</span></code></b> (input_control)  </span><span>real <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">float</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real)</span><span data-if="dotnet" style="display:none"> (<i>double</i>)</span><span data-if="cpp" style="display:none"> (<i>double</i>)</span><span data-if="c" style="display:none"> (<i>double</i>)</span></span>
</div>
<p class="pardesc">Threshold for clustering the initial components.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0.5</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0.0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0</p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>0 &lt;= ClusterThreshold &amp;&amp; ClusterThreshold &lt;= 1</code></p>
</div>
<h2 id="sec_example_all">例程 (HDevelop)</h2>
<pre class="example">
* Get the model image.
read_image (ModelImage, 'model_image.tif')
* Define the regions for the initial components.
gen_rectangle2 (InitialComponentRegions, 212, 233, 0.62, 167, 29)
gen_rectangle2 (Rectangle2, 298, 363, 1.17, 162, 34)
gen_rectangle2 (Rectangle3, 63, 444, -0.26, 50, 27)
gen_rectangle2 (Rectangle4, 120, 473, 0, 33, 20)
concat_obj (InitialComponentRegions, Rectangle2, InitialComponentRegions)
concat_obj (InitialComponentRegions, Rectangle3, InitialComponentRegions)
concat_obj (InitialComponentRegions, Rectangle4, InitialComponentRegions)
* Get the training images
gen_empty_obj (TrainingImages)
for i := 1 to 4 by 1
    read_image (TrainingImage, 'training_image-'+i$'02'+'.tif')
    concat_obj (TrainingImages, TrainingImage, TrainingImages)
endfor
* Extract the model components and train the relations.
train_model_components (ModelImage, InitialComponentRegions, \
                        TrainingImages, ModelComponents, 22, 60, 30, 0.65, \
                        0, 0, rad(60), 'speed', 'rigidity', 0.2, 0.5, \
                        ComponentTrainingID)
* Find the best value for the parameter ClusterThreshold.
inspect_clustered_components (ModelComponents, ComponentTrainingID, \
                              'rigidity', 0.2, 0.4)
* Adopt the ClusterThreshold into the training result.
cluster_model_components (TrainingImages, ModelComponents, \
                          ComponentTrainingID, 'rigidity', 0.2, 0.4)
* Create the component model based on the training result.
create_trained_component_model (ComponentTrainingID, -rad(30), rad(60), \
                                10, 0.5, 'auto', 'auto', 'none', \
                                'use_polarity', 'false', ComponentModelID, \
                                RootRanking)
</pre>
<h2 id="sec_result">结果</h2>
<p>If the parameter values are correct, 该算子
<code><span data-if="hdevelop" style="display:inline">cluster_model_components</span><span data-if="c" style="display:none">cluster_model_components</span><span data-if="cpp" style="display:none">ClusterModelComponents</span><span data-if="com" style="display:none">ClusterModelComponents</span><span data-if="dotnet" style="display:none">ClusterModelComponents</span><span data-if="python" style="display:none">cluster_model_components</span></code> 返回值 <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
    .  If the input is
empty (no input images are available) the behavior can be set via
<a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system('no_object_result',&lt;Result&gt;)</span><span data-if="c" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span><span data-if="cpp" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="com" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="dotnet" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="python" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span></code></a>.  If necessary, an
exception is raised.</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="train_model_components.html"><span data-if="hdevelop" style="display:inline">train_model_components</span><span data-if="c" style="display:none">train_model_components</span><span data-if="cpp" style="display:none">TrainModelComponents</span><span data-if="com" style="display:none">TrainModelComponents</span><span data-if="dotnet" style="display:none">TrainModelComponents</span><span data-if="python" style="display:none">train_model_components</span></a></code>, 
<code><a href="inspect_clustered_components.html"><span data-if="hdevelop" style="display:inline">inspect_clustered_components</span><span data-if="c" style="display:none">inspect_clustered_components</span><span data-if="cpp" style="display:none">InspectClusteredComponents</span><span data-if="com" style="display:none">InspectClusteredComponents</span><span data-if="dotnet" style="display:none">InspectClusteredComponents</span><span data-if="python" style="display:none">inspect_clustered_components</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="get_training_components.html"><span data-if="hdevelop" style="display:inline">get_training_components</span><span data-if="c" style="display:none">get_training_components</span><span data-if="cpp" style="display:none">GetTrainingComponents</span><span data-if="com" style="display:none">GetTrainingComponents</span><span data-if="dotnet" style="display:none">GetTrainingComponents</span><span data-if="python" style="display:none">get_training_components</span></a></code>, 
<code><a href="create_trained_component_model.html"><span data-if="hdevelop" style="display:inline">create_trained_component_model</span><span data-if="c" style="display:none">create_trained_component_model</span><span data-if="cpp" style="display:none">CreateTrainedComponentModel</span><span data-if="com" style="display:none">CreateTrainedComponentModel</span><span data-if="dotnet" style="display:none">CreateTrainedComponentModel</span><span data-if="python" style="display:none">create_trained_component_model</span></a></code>, 
<code><a href="modify_component_relations.html"><span data-if="hdevelop" style="display:inline">modify_component_relations</span><span data-if="c" style="display:none">modify_component_relations</span><span data-if="cpp" style="display:none">ModifyComponentRelations</span><span data-if="com" style="display:none">ModifyComponentRelations</span><span data-if="dotnet" style="display:none">ModifyComponentRelations</span><span data-if="python" style="display:none">modify_component_relations</span></a></code>, 
<code><a href="write_training_components.html"><span data-if="hdevelop" style="display:inline">write_training_components</span><span data-if="c" style="display:none">write_training_components</span><span data-if="cpp" style="display:none">WriteTrainingComponents</span><span data-if="com" style="display:none">WriteTrainingComponents</span><span data-if="dotnet" style="display:none">WriteTrainingComponents</span><span data-if="python" style="display:none">write_training_components</span></a></code>, 
<code><a href="get_component_relations.html"><span data-if="hdevelop" style="display:inline">get_component_relations</span><span data-if="c" style="display:none">get_component_relations</span><span data-if="cpp" style="display:none">GetComponentRelations</span><span data-if="com" style="display:none">GetComponentRelations</span><span data-if="dotnet" style="display:none">GetComponentRelations</span><span data-if="python" style="display:none">get_component_relations</span></a></code>, 
<code><a href="clear_training_components.html"><span data-if="hdevelop" style="display:inline">clear_training_components</span><span data-if="c" style="display:none">clear_training_components</span><span data-if="cpp" style="display:none">ClearTrainingComponents</span><span data-if="com" style="display:none">ClearTrainingComponents</span><span data-if="dotnet" style="display:none">ClearTrainingComponents</span><span data-if="python" style="display:none">clear_training_components</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Matching</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
